gdk: Documentation improvements

Document some new x11 symbols.

diff --git a/docs/reference/gdk/gdk4-sections.txt b/docs/reference/gdk/gdk4-sections.txt
index 2a9afa811098b4a5747498f7b4daaa4eaaface57..8eb27f7c89a71835eb9eb6c92aa44664cf3fb7d2 100644 (file)
--- a/docs/reference/gdk/gdk4-sections.txt
+++ b/docs/reference/gdk/gdk4-sections.txt
@@ -231,6 +231,7 @@ gdk_surface_get_scale_factor
 gdk_surface_set_opaque_region
 gdk_surface_create_gl_context
 gdk_surface_create_vulkan_context
+gdk_surface_create_cairo_context
 
 <SUBSECTION>
 gdk_surface_queue_expose
@@ -988,7 +989,6 @@ gdk_wayland_device_get_wl_seat
 gdk_wayland_display_get_wl_compositor
 gdk_wayland_display_get_wl_display
 gdk_wayland_display_query_registry
-gdk_wayland_surface_new_subsurface
 gdk_wayland_surface_get_wl_surface
 GdkWaylandSurfaceExported
 gdk_wayland_surface_export_handle

diff --git a/gdk/x11/gdksurface-x11.c b/gdk/x11/gdksurface-x11.c
index 4da000c5966fe7395e6ec418cf240b38496973ca..9dfeb06703dd9aa61bf86ef9aad5fe648d77fdac 100644 (file)
--- a/gdk/x11/gdksurface-x11.c
+++ b/gdk/x11/gdksurface-x11.c
@@ -1870,7 +1870,10 @@ gdk_x11_surface_set_modal_hint (GdkSurface *surface,
 /**
  * gdk_x11_surface_set_skip_taskbar_hint:
  * @surface: (type GdkX11Surface): a native #GdkSurface
- * @skips_taskbar:
+ * @skips_taskbar: %TRUE to skip taskbars
+ *
+ * Sets a hint on @surface that taskbars should not
+ * display it. See the EWMH for details.
  */
 void
 gdk_x11_surface_set_skip_taskbar_hint (GdkSurface *surface,
@@ -1895,8 +1898,11 @@ gdk_x11_surface_set_skip_taskbar_hint (GdkSurface *surface,
 
 /**
  * gdk_x11_surface_set_skip_pager_hint:
- * @surface: (type GdkX11Surface): a native #GdkSurface
- * @skips_pager:
+ * @surface: (type GdkX11Surface): a #GdkSurface
+ * @skips_pager: %TRUE to skip pagers
+ *
+ * Sets a hint on @surface that pagers should not
+ * display it. See the EWMH for details.
  */
 void
 gdk_x11_surface_set_skip_pager_hint (GdkSurface *surface,
@@ -1922,7 +1928,10 @@ gdk_x11_surface_set_skip_pager_hint (GdkSurface *surface,
 /**
  * gdk_x11_surface_set_urgency_hint:
  * @surface: (type GdkX11Surface): a native #GdkSurface
- * @urgent:
+ * @urgent: %TRUE to indicate urgenct attention needed
+ *
+ * Sets a hint on @surface that it needs user attention.
+ * See the ICCCM for details.
  */
 void
 gdk_x11_surface_set_urgency_hint (GdkSurface *surface,
@@ -3396,6 +3405,9 @@ gdk_x11_surface_get_group (GdkSurface *surface)
  * gdk_x11_surface_set_group:
  * @surface: (type GdkX11Surface): a native #GdkSurface
  * @leader: a #GdkSurface
+ *
+ * Sets the group leader of @surface to be @leader.
+ * See the ICCCM for details.
  */
 void
 gdk_x11_surface_set_group (GdkSurface *surface,